Skip to content

Conversation

@MikeMcC399
Copy link
Contributor

Checklist

  • npm install && npm run lint && npm test passes
  • documentation is changed or added
  • commit message follows commit guidelines

Situation

Python instructions to install on Windows changed with the release of Python 3.14 in October 2025.

Python 3.14 documentation says:

To obtain Python from the CPython team, use the Python Install Manager. This is a standalone tool that makes Python available as global commands on your Windows machine, integrates with the system, and supports updates over time. You can download the Python Install Manager from python.org/downloads or through the Microsoft Store app.

Python 3.14 is not available as a separate package in the Microsoft Store, unlike Python 3.12 and 3.13.

The Python Install Manager can be used to install 3.14 and other versions.

Description of change

In the README > On Windows section change the manual install instructions to:

Follow the instructions in Using Python on Windows to install the current version of Python.

@MikeMcC399
Copy link
Contributor Author

@cclauss
Copy link
Contributor

cclauss commented Jan 11, 2026

Alternatively we could point to the Windows install manager at:

@MikeMcC399
Copy link
Contributor Author

@cclauss

Alternatively we could point to the Windows install manager at:

Pointing to the documentation https://docs.python.org/3/using/windows.html gives more comprehensive information, including different choices of where to get the Python install manager for Windows and how to use the Python install manager.

When I started to migrate to Python 3.14 I found that I needed this documentation.

If you want to point instead to the download page, https://www.python.org/downloads (one level higher) presents simpler information. The contents depends on the operating system where the browser is running and from Windows it looks like this:

image

this is easier on the eyes compared to https://www.python.org/downloads/windows

https://www.python.org/downloads/windows

image

Another possibility would be to use https://www.python.org/downloads and include a link to https://docs.python.org/3/using/windows.html

That may be the best way.

Would be great to hear also from @StefanStojanovic about his thoughts!

@MikeMcC399
Copy link
Contributor Author

MikeMcC399 commented Jan 12, 2026

My original (short) suggestion, which delegates the instructions to the Python docs, is:

Follow the instructions in Using Python on Windows to install the current version of Python.

An alternate longer suggestion, which links directly to the download location would be:

To install the current version of Python use the Python Install Manager, which can be installed from the Microsoft Store app or downloaded and installed from python/downloads. Refer to the documentation Using Python on Windows for Python Install Manager usage instructions.

I prefer the shorter version.

@StefanStojanovic
Copy link
Contributor

Generally speaking, I'm more in favor of shorter docs, as long as it gives all the info you need.

@MikeMcC399
Copy link
Contributor Author

Is readme: all right for the commit message? I took it from release-please-config.json or would doc: or docs: be preferred?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Outdated Python 3.14 manual install instructions on Windows

3 participants